Created shared-data-source.md #1853
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
|
||
| # Sharing Resources with Assets Manager | ||
|
|
||
| To share resources (like company logo, data files) when crafting reports in the [Web Report Designer](https://demos.telerik.com/reporting/designer), Telerik Reporting offers the **Assets Manager** tool. It is designed to help report authors manage shared resources used across multiple reports. It provides centralized resource management which allows uploading, organizing, renaming, and deleting various types of assets directly on the server. The **Assets Manager** ensures a unified consistent look and feel across reports and enables teams to work together - data experts can manage sources, while designers focus on presentation. |
There was a problem hiding this comment.
Suggested change
| To share resources (like company logo, data files) when crafting reports in the [Web Report Designer](https://demos.telerik.com/reporting/designer), Telerik Reporting offers the **Assets Manager** tool. It is designed to help report authors manage shared resources used across multiple reports. It provides centralized resource management which allows uploading, organizing, renaming, and deleting various types of assets directly on the server. The **Assets Manager** ensures a unified consistent look and feel across reports and enables teams to work together - data experts can manage sources, while designers focus on presentation. | |
| To share resources (like company logos, data files) when crafting reports in the [Web Report Designer](https://demos.telerik.com/reporting/designer), use the **Assets Manager**, which helps you manage shared resources used across multiple reports. It provides centralized resource management, allowing users to upload, organize, rename, and delete various types of assets directly on the server. Shared report resources ensure a unified, consistent look and feel across reports and enable teams to work together—data experts can manage sources, while designers focus on presentation. |
|
|
||
|  | ||
|
|
||
| ## What Resources You Can Share |
There was a problem hiding this comment.
Suggested change
| ## What Resources You Can Share | |
| ## What Resources Can You Share? |
|
|
||
| ## What Resources You Can Share | ||
|
|
||
| You can share and reuse: |
There was a problem hiding this comment.
Suggested change
| You can share and reuse: | |
| In the Web Report Designer, you can share and reuse: |
|
|
||
| You can share and reuse: | ||
|
|
||
| * **Images** (e.g., logos, backgrounds): Suitable for using a company logo accross multiple reports when the logo is stored at one centralized place. |
There was a problem hiding this comment.
Avoid using abbreviations of Latin origin.
Suggested change
| * **Images** (e.g., logos, backgrounds): Suitable for using a company logo accross multiple reports when the logo is stored at one centralized place. | |
| * **Images** (for example, logos, backgrounds): Suitable for using a company logo across multiple reports when the logo is stored at one centralized place. |
|
|
||
| * **Images** (e.g., logos, backgrounds): Suitable for using a company logo accross multiple reports when the logo is stored at one centralized place. | ||
|
|
||
| * **Data files** (e.g., CSV, JSON, shapefiles): Share common data that can be reused accross multiple users. |
There was a problem hiding this comment.
Suggested change
| * **Data files** (e.g., CSV, JSON, shapefiles): Share common data that can be reused accross multiple users. | |
| * **Data files** (for example, CSV, JSON, shapefiles): Share common data that can be reused across multiple users. |
|
|
||
| To help you manage your shared resources with ease and flexibility the Assets Manager is packed with a rich set of UI intuitive features: | ||
|
|
||
| * **Choose Your View: Grid or List** |
There was a problem hiding this comment.
Style the list items consistently.
Suggested change
| * **Choose Your View: Grid or List** | |
| * **Choose Your View: Grid or List**—You can switch between Grid View and List View depending on your workflow. The Grid View also supports column resizing for better visibility. |
| |----|----| | ||
| | | | | ||
|
|
||
| * **Manage Files Effortlessly**: Upload, download, rename, move, or delete files and folders - all in one place. You can even drag and drop files directly into the manager for quick uploads. |
There was a problem hiding this comment.
Suggested change
| * **Manage Files Effortlessly**: Upload, download, rename, move, or delete files and folders - all in one place. You can even drag and drop files directly into the manager for quick uploads. | |
| * **Manage Files**—Upload, download, rename, move, or delete files and folders—all in one place. You can also drag and drop files directly into the manager for quick uploads. |
|
|
||
| * **Manage Files Effortlessly**: Upload, download, rename, move, or delete files and folders - all in one place. You can even drag and drop files directly into the manager for quick uploads. | ||
|
|
||
| * **View Asset Details Instantly**: Want to see more info about a file? Just select an asset and toggle the `View Details` button. A panel on the right will show metadata like file name, type, and size: |
There was a problem hiding this comment.
Suggested change
| * **View Asset Details Instantly**: Want to see more info about a file? Just select an asset and toggle the `View Details` button. A panel on the right will show metadata like file name, type, and size: | |
| * **View Asset Details**—Selecting an asset and toggling the **View Details** button brings up a panel on the right that shows metadata like file name, type, and size: |
|
|
||
|  | ||
|
|
||
| * **Quick Access to Recent Assets**: No need to search for files you just used - your recently accessed assets are tracked and easily accessible. |
There was a problem hiding this comment.
Suggested change
| * **Quick Access to Recent Assets**: No need to search for files you just used - your recently accessed assets are tracked and easily accessible. | |
| * **Quick Access to Recent Assets**—Your recently accessed assets are tracked and easily accessible. |
|
|
||
|  | ||
|
|
||
| * **Organize Reports for Report Books**: If you are creating a Report Book, use the Assets Manager to select and organize individual reports into a cohesive, multi-report document. |
There was a problem hiding this comment.
Suggested change
| * **Organize Reports for Report Books**: If you are creating a Report Book, use the Assets Manager to select and organize individual reports into a cohesive, multi-report document. | |
| * **Organize Reports for Report Books**—If you are creating a Report Book, use the Assets Manager to select and organize individual reports into a cohesive, multi-report document. |
|
|
||
|  | ||
|
|
||
| | Name | Description | |
There was a problem hiding this comment.
"Name" is too broad. Is this a built-in expression component?
| } | ||
| </style> | ||
|
|
||
| # Customizing Report Items - Overview |
There was a problem hiding this comment.
Suggested change
| # Customizing Report Items - Overview | |
| # Customizing Report Items: Overview |
|
|
||
| # Customizing Report Items - Overview | ||
|
|
||
| A well-styled report looks professional and polished. Styling report items serves both, functional and aesthetic, purposes. Visual consistency (e.g., using a theme or style rules) improves user experience and brand alignment. It allows you to improve readability and clarity in your reports. Applying different colors or fonts distinguishes separate sections or highlight key information. |
There was a problem hiding this comment.
Suggested change
| A well-styled report looks professional and polished. Styling report items serves both, functional and aesthetic, purposes. Visual consistency (e.g., using a theme or style rules) improves user experience and brand alignment. It allows you to improve readability and clarity in your reports. Applying different colors or fonts distinguishes separate sections or highlight key information. | |
| A well-styled report looks professional, clear, and is easy to read. Styling report items serves both functional and aesthetic purposes. Visual consistency (for example, using the same theme or style rules) improves user experience and supports brand alignment. Applying different colors or fonts lets you highlight specific sections or key information. |
| # Customizing Report Items - Overview | ||
|
|
||
| A well-styled report looks professional and polished. Styling report items serves both, functional and aesthetic, purposes. Visual consistency (e.g., using a theme or style rules) improves user experience and brand alignment. It allows you to improve readability and clarity in your reports. Applying different colors or fonts distinguishes separate sections or highlight key information. | ||
| To customize or style report items in the Telerik Web Report Designer, you can use its built-in CSS-like styling model and the Properties panel. |
There was a problem hiding this comment.
- I suggest making this sentence the first one in the article, as it provides a good overview of the article.
- Are you sure that the users of this documentation know what CSS is?
Suggested change
| To customize or style report items in the Telerik Web Report Designer, you can use its built-in CSS-like styling model and the Properties panel. | |
| To customize or style report items in the Telerik Web Report Designer, you can use the built-in styling model and the variety of style-related properties in the Properties panel on the right. |
| A well-styled report looks professional and polished. Styling report items serves both, functional and aesthetic, purposes. Visual consistency (e.g., using a theme or style rules) improves user experience and brand alignment. It allows you to improve readability and clarity in your reports. Applying different colors or fonts distinguishes separate sections or highlight key information. | ||
| To customize or style report items in the Telerik Web Report Designer, you can use its built-in CSS-like styling model and the Properties panel. | ||
|
|
||
| ## Properties Area - What Is It For |
There was a problem hiding this comment.
Suggested change
| ## Properties Area - What Is It For | |
| ## Using the Properties Panel |
|
|
||
| ## Properties Area - What Is It For | ||
|
|
||
| The **Properties Area** lets you control how each report item looks and behaves. Whether you are working with a TextBox, Table, Chart, or Image, this panel gives you access to all the relevant settings in one place: |
There was a problem hiding this comment.
Suggested change
| The **Properties Area** lets you control how each report item looks and behaves. Whether you are working with a TextBox, Table, Chart, or Image, this panel gives you access to all the relevant settings in one place: | |
| By using the Properties Panel, you can control the appearance and behavior of each report item. Whether you are working with a TextBox, Table, Chart, or Image, this panel gives you access to all the relevant settings in one place: |
| * **Switch Between Views That Work for You**: Choose the layout that fits your style: | ||
|
|
||
| * **Categorized View**: Groups properties by function (like Appearance, Layout, Data), making it easier to find what you need. | ||
| * **Alphabetical View**: Lists everything in order - perfect if you know exactly what you're looking for. |
There was a problem hiding this comment.
Suggested change
| * **Alphabetical View**: Lists everything in order - perfect if you know exactly what you're looking for. | |
| * **Alphabetical view**: Lists everything in order—perfect when you know exactly what you're looking for. |
| |----|----| | ||
| | || | ||
|
|
||
| * **Visualize Property Hierarchies with Indent Guides**: In case of nested properties Indent Line Guides help you see how settings are structured, so you can navigate complex items with confidence: |
There was a problem hiding this comment.
Suggested change
| * **Visualize Property Hierarchies with Indent Guides**: In case of nested properties Indent Line Guides help you see how settings are structured, so you can navigate complex items with confidence: | |
| * **See property hierarchies**—The indentation of the properties helps you understand and navigate the structure of the settings: |
|
|
||
| * **Switch Between Views That Work for You**: Choose the layout that fits your style: | ||
|
|
||
| * **Categorized View**: Groups properties by function (like Appearance, Layout, Data), making it easier to find what you need. |
There was a problem hiding this comment.
Suggested change
| * **Categorized View**: Groups properties by function (like Appearance, Layout, Data), making it easier to find what you need. | |
| * **Categorized view**: Groups properties by function (like Appearance, Layout, Data), making it easier to find what you need. |
|
|
||
|  | ||
|
|
||
| * **Find What You Need Fast**: Use the Global Search bar at the top to instantly locate any property or editor. No more scrolling through long lists! |
There was a problem hiding this comment.
Suggested change
| * **Find What You Need Fast**: Use the Global Search bar at the top to instantly locate any property or editor. No more scrolling through long lists! | |
| * **Search properties**—Use the Search box at the top to locate any property or editor. |
|  | ||
|
|
||
|
|
||
| ### Reset with a Click |
There was a problem hiding this comment.
This should also be a bullet in the list above, not a section with a heading.
yordan-mitev
reviewed
Nov 3, 2025
| } | ||
| </style> | ||
|
|
||
| # Conditional Formatting |
There was a problem hiding this comment.
Suggested change
| # Conditional Formatting | |
| # Using Conditional Formatting |
|
|
||
| # Conditional Formatting | ||
|
|
||
| To visually highlight important data, **Conditional formatting** lets you automatically style report items based on the values they display making your reports more dynamic and easier to read. For example, you can set a TextBox showing revenue to turn red if the value drops below 10,000. This helps draw attention to numbers that need review or action. |
There was a problem hiding this comment.
Aim for concise introduction that explains the purpose without repeating information. For example:
- "visually highlight" is redundant in the context of a report.
- "visually highlight important data" describes the same intent as "draw attention".
- Don't use bold to highlight new terms. We use italic, as described in the Style Guide.
Suggested change
| To visually highlight important data, **Conditional formatting** lets you automatically style report items based on the values they display making your reports more dynamic and easier to read. For example, you can set a TextBox showing revenue to turn red if the value drops below 10,000. This helps draw attention to numbers that need review or action. | |
| Using *conditional formatting* lets you apply styles to report items automatically based on data values or expression results. For example, you can set a revenue TextBox to display in red when its value is less than 10000, helping users quickly spot underperforming figures. |
|
|
||
| ## Formatting a Single Item | ||
|
|
||
| Watch this quick tutorial to learn how to apply conditional formatting to a LineTotal TextBox in a table - changing its color to red when the *value is less than 50*: |
There was a problem hiding this comment.
- As you make the distinction between formatting a single item vs. multiple items, make sure you open this new section with a sentence that explains when formatting a single item is the right approach for the report.
- Don't rely only on the video, add a simplified step-by-step instruction as well.
- "Watch this" is too informal, aim for a neutral tone.
Suggested change
| Watch this quick tutorial to learn how to apply conditional formatting to a LineTotal TextBox in a table - changing its color to red when the *value is less than 50*: | |
| [Your text explaining when to use conditional formatting for a single item]. | |
| [Simplified step-by-step instructions]. | |
| The quick video tutorial below shows how to apply conditional formatting to a LineTotal TextBox in a table by changing its color to red when a value is less than 50. |
|
|
||
| ## Formatting Multiple Items | ||
|
|
||
| While conditional formatting works great on individual items, applying it to multiple selected items at once is a challenge. When **multiple** items are selected, even though ConditionalFormatting is technically supported on each individual item, the designer cannot guarantee consistent behavior across all selected items. Hence, it does not allow batch editing of conditional formatting rules to make for example alternating row style for all the cells belonging to the table row. It requires you to apply rules **individually** to each item: |
There was a problem hiding this comment.
- "While conditional formatting works great on individual items..." sounds like you are saying that multiple items formatting doesn't work. Aim for something more neutral.
Suggested change
| While conditional formatting works great on individual items, applying it to multiple selected items at once is a challenge. When **multiple** items are selected, even though ConditionalFormatting is technically supported on each individual item, the designer cannot guarantee consistent behavior across all selected items. Hence, it does not allow batch editing of conditional formatting rules to make for example alternating row style for all the cells belonging to the table row. It requires you to apply rules **individually** to each item: | |
| Applying conditional formatting to multiple selected items at once is less straight forward than formatting a single item. Although conditional formatting is supported on all individual report items, selecting multiple items and applying formatting to all of them at once is not supported. | |
| To apply or edit the conditional formatting rules for multiple report items: | |
| 1. Select each item (for example, a TextBox) one at a time. | |
| 1. Add the conditional formatting rule to each item one at a time. |
| ## Formatting Multiple Items | ||
|
|
||
| While conditional formatting works great on individual items, applying it to multiple selected items at once is a challenge. When **multiple** items are selected, even though ConditionalFormatting is technically supported on each individual item, the designer cannot guarantee consistent behavior across all selected items. Hence, it does not allow batch editing of conditional formatting rules to make for example alternating row style for all the cells belonging to the table row. It requires you to apply rules **individually** to each item: | ||
| * Select each TextBox (or other report item) one at a time. |
There was a problem hiding this comment.
Suggested change
| * Select each TextBox (or other report item) one at a time. |
|
|
||
| While conditional formatting works great on individual items, applying it to multiple selected items at once is a challenge. When **multiple** items are selected, even though ConditionalFormatting is technically supported on each individual item, the designer cannot guarantee consistent behavior across all selected items. Hence, it does not allow batch editing of conditional formatting rules to make for example alternating row style for all the cells belonging to the table row. It requires you to apply rules **individually** to each item: | ||
| * Select each TextBox (or other report item) one at a time. | ||
| * Add the same conditional formatting rule manually. |
There was a problem hiding this comment.
Suggested change
| * Add the same conditional formatting rule manually. |
| * Select each TextBox (or other report item) one at a time. | ||
| * Add the same conditional formatting rule manually. | ||
|
|
||
| To save time, you can group items inside a Panel and apply the conditional formatting to the panel itself. This way, all nested items inherit the style based on the condition. This approach is shown in the following video: |
There was a problem hiding this comment.
Suggested change
| To save time, you can group items inside a Panel and apply the conditional formatting to the panel itself. This way, all nested items inherit the style based on the condition. This approach is shown in the following video: | |
| To improve your productivity when applying conditional formatting to many items, add a [Panel item]({%slug user-guide/components/report-items%}#panel) and group these target items inside the Panel. Then, apply the conditional formatting to the panel itself. This way, all items placed in the Panel inherit the style applied by the condition you set. | |
| The following video shows how to use a Panel to apply conditional formatting to multiple report items. |
yordan-mitev
reviewed
Nov 3, 2025
| @@ -0,0 +1,98 @@ | |||
| --- | |||
| title: StyleSheet Formatting | |||
There was a problem hiding this comment.
Suggested change
| title: StyleSheet Formatting | |
| title: Using Style Sheets |
| @@ -0,0 +1,98 @@ | |||
| --- | |||
| title: StyleSheet Formatting | |||
| page_title: Web Report Designer - StyleSheet Formatting | |||
There was a problem hiding this comment.
Suggested change
| page_title: Web Report Designer - StyleSheet Formatting | |
| page_title: Web Report Designer - Using Style Sheets |
| } | ||
| </style> | ||
|
|
||
| # StyleSheet Formatting |
There was a problem hiding this comment.
Suggested change
| # StyleSheet Formatting | |
| # Using Style Sheets in Reports |
|
|
||
| # StyleSheet Formatting | ||
|
|
||
| To keep your report design clean, consistent, and easy to manage StyleSheets in the Web Report Designer let you apply centralized, reusable styles - just like CSS in web development. |
There was a problem hiding this comment.
Suggested change
| To keep your report design clean, consistent, and easy to manage StyleSheets in the Web Report Designer let you apply centralized, reusable styles - just like CSS in web development. | |
| Using style sheets in the Web Report Designer lets you apply centralized, reusable styles to multiple report items, similar to CSS in web development. |
| To keep your report design clean, consistent, and easy to manage StyleSheets in the Web Report Designer let you apply centralized, reusable styles - just like CSS in web development. | ||
|
|
||
|
|
||
| To apply formatting via external stylesheets, you can use a CSS-like styling model that allows centralized and reusable styling across multiple report items. |
There was a problem hiding this comment.
Suggested change
| To apply formatting via external stylesheets, you can use a CSS-like styling model that allows centralized and reusable styling across multiple report items. | |
| The Web Report Designer allows you to use two types of style sheets: | |
| * Quick style sheets that you create for each report and that live within each report | |
| * External style sheets that live in a separate file and that you can reuse across reports |
|
|
||
| <iframe width="560" height="315" src="https://www.youtube.com/embed/HIjkZc48abM?si=aUZKq7TlyfuwBIp2" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe> | ||
|
|
||
| ## Using External StyleSheets |
There was a problem hiding this comment.
Suggested change
| ## Using External StyleSheets | |
| ## Using External Style Sheets |
|
|
||
| In the Web Report Designer: | ||
|
|
||
| 1. Select the **Report** object. |
There was a problem hiding this comment.
This step isn't shown in the video. Make sure the video and the steps you describe are identical.
|
|
||
| 1. Select the **Report** object. | ||
|
|
||
| 1. Go to the StyleSheet property. |
There was a problem hiding this comment.
Not in the video as well. The video shows using the search box.
|
|
||
| 1. Add Selectors to target specific items (e.g., all TextBox, PictureBox items). | ||
|
|
||
| The following tutorial shows how to define a StyleRule in the report's StyleSheet and apply the style to multiple items using selectors (e.g., by item name or type): |
There was a problem hiding this comment.
Suggested change
| The following tutorial shows how to define a StyleRule in the report's StyleSheet and apply the style to multiple items using selectors (e.g., by item name or type): | |
| The following tutorial shows how to define a style rule in the report's style sheet and apply the style to multiple items by using selectors (for example, by item name or type): |
|
|
||
| ## Using External StyleSheets | ||
|
|
||
| If you want to keep your styles in a separate file, use an external StyleSheet (XML format) to define and apply styles across reports. An external StyleSheet is an XML file that contains StyleRules. These rules define how report items should look - similar to CSS in web development. You can apply styles based on: |
There was a problem hiding this comment.
Suggested change
| If you want to keep your styles in a separate file, use an external StyleSheet (XML format) to define and apply styles across reports. An external StyleSheet is an XML file that contains StyleRules. These rules define how report items should look - similar to CSS in web development. You can apply styles based on: | |
| External style sheets (XML files) allow you to reuse style rules across multiple reports. This type of style sheets are external to each report and this allows you to reference them from an arbitrary number of reports. Each style sheets file contains one or more style rules that define how report items must look. | |
| You can apply styles based on: |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.